package cn.gemiman.daoyi.module.cms.service.tagdictionary;

import java.util.*;

import cn.gemiman.daoyi.module.cms.dal.dataobject.blogmessage.BlogMessageDO;
import jakarta.validation.*;
import cn.gemiman.daoyi.module.cms.controller.admin.tagdictionary.vo.*;
import cn.gemiman.daoyi.module.cms.dal.dataobject.tagdictionary.TagDictionaryDO;
import cn.gemiman.daoyi.framework.common.pojo.PageResult;
import cn.gemiman.daoyi.framework.common.pojo.PageParam;

/**
 * 文章标签 Service 接口
 *
 * @author 道一源码
 */
public interface TagDictionaryService {

    /**
     * 创建文章标签
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createTagDictionary(@Valid TagDictionarySaveReqVO createReqVO);

    /**
     * 更新文章标签
     *
     * @param updateReqVO 更新信息
     */
    void updateTagDictionary(@Valid TagDictionarySaveReqVO updateReqVO);

    /**
     * 删除文章标签
     *
     * @param id 编号
     */
    void deleteTagDictionary(Long id);

    /**
     * 获得文章标签
     *
     * @param id 编号
     * @return 文章标签
     */
    TagDictionaryDO getTagDictionary(Long id);

    /**
     * 获得文章标签
     *
     * @return 文章标签
     */
    List<String> getTagDictionary();

    /**
     * 获得文章标签分页
     *
     * @param pageReqVO 分页查询
     * @return 文章标签分页
     */
    PageResult<TagDictionaryDO> getTagDictionaryPage(TagDictionaryPageReqVO pageReqVO);

    /**
     * 获得留言标签列表
     *
     * @return 留言标签列表
     */
    List<TagDictionaryDO> getHotMessageTagList(String appId);
}
